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TRS-80® 
MODEL III 
MICRO- 
COMPUTER 
SYSTEM 




Start-Up 



The entire system (Computer and peripherals) 
should be OFF. 

1. Turn all peripherals ON. 

2. Turn the Computer ON. 

3. The message: 

Cass? 
should be displayed. To soled the High 
cassette speed (1500 baud), press [~JD or 
C ENTER) . To select the Low cassette speed (500 
baud), press QJ. 

For general purposes, use High. To load or 
save Model I Level II basic programs, you must 
use Low. 

4. The message: 

Mewo TV Si2t? 
will be displayed. To use all available memory, 
press CENTER). To reserve some high memory, 
type in the highest address (in decimal) that 
you want to use. ihen press -ENTER"). 

G. The start-up message, followed by the HEADY 
prompt, will be displayed. The computer is now 
ready to use. 
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Statements 



AUTO 3t*rt w incr*a*eitt Numbers lines automatically. 

AUTO AUTO 150 p Z« AUTO i3 

CLEARb Reserves n byleS pi string storage space; 

initializes all variables 

CLEAR CLE Aft 75 CLEAR * 

CLOAD Loads BAS-iC program (lie 'rom cassetle Only 

the first character of lha file name is used, 
CLOAD CLDAD "MIX1T 

CLOAD? Compares program on tape byte-tor-byie with 

reskieni program. 
CLOAQ" CLDAD? 'HIXIT" 

CLS Clears the display. 

CIS 

CONT Continues execulion of program after : BHE*K or 

STOP. 

CDNT 

CSAVE Siores resident program on cassefle tape. A tilg 

name is required- Onry me firs! character of the file name is 
used. 

CSAVE "HIXIT" 

DATA Stores data to be accessed by a READ slatsmwil. 

DATA 'LINCOLN p A . " p l9Gli "ILLINOIS" 

DEFDBL Delmes variables as doubte-precisign. 

DEFDBL U f M-Z 

[>EF1NT Defines variables as int&g&t type. 

DEFINT A r 1-N 

DEFSNG Defines variables as single-precision. 

DEFSNG ] i W-Z 

DEFSTB Defines variables as string type. 

DEFSTRf C< L-Z 

DELETE Erases program lines from memory. 

DELETE 1283 DELETE -BB DE_ETt 

DIM Dimensions one or more arrays. 

DIM R<73) . M(fl0> Sltl HfitiE) 25) 
DIM LI13p 10 i SI 

EDIT Puis computer into edit mode tor specified line. 

Strt Edit CamDundi. 

EDIT tee EDIT. 




END Ends program execution. 

END 

Fnuoni n) Simulates the spsclfied error, n » 1 - £3. 

ERRDR! 1) 

FOR_T0 M ,STEF,WECT Opens program loop. 

FOR 1 - 1 TO B NEXT 1 

FDR Cl»» TO 5 BTEP .2 (,,<> NEXT C! 

GOSUB Transfers program control Id the specified 

subroutine, 
CD5UB 75B 

GOTO Transfers program control to the specified line. 

GDTD IB* 

IF _THEN.„El£E Tests conditional expression, 

[F P ■ a THEN 20fl 
IF M '.t THEN 15« ELS£ NI = N3-] 

INPUT Inputs data from keyboard. 

INPUT X* INPUT Li l"l i N 

INPUT"WE*T" IN 

INPUT # - I I nputs dale, from cassette. 

INPUT n-l « ft 

LET Assigns value to variable (oplionalf. 

LET X - 7-U5 LET P2 - Rl 

LET Ci • "RED" 

LIST Lists program lines to the video display. 

LIST LIST 5*-B5 

LUST Lisls program lines to the line printer. 

LLIST LL1ST 30- 

LPRINT PrinlS en item pr list of items on lhe printer 

LPRINT CfiPti "IS THE CAPITAL OF" I ST4 

LPRINT TAB Moves printer carriage to specified 

position. 

LPRINT TABTZS) "NAME" 

LPRINT USING Prints formatted numbers and strings 

on Ihe printer. See PRINT USING for list of field specifiers 

LPRINT USING >i»s# f "i 1.23(1 

NEW Erases program from m-emory; initializes all 

variables 

NEU 

ON ERROR GOTO Sets up an erfor-haixHirig routine. 

DN ERROR GDTD 2\Q$ 
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ON LKHOK GOtO Disables an error -handling 

routine. 

ON ERRDR GOTO & 

ON...G05UB MulC<way branch to specified subroutines. 

ON T GDSUB 5tfp 100 r 15ft . 200 

ON. ..GOTO Mulli-way branch Id specified lines. 

DN X GDTD 19»p 283 , 2 10 

OUTp, v Sends value tp specified pgrt. p end u = 

255 

OUT 255 f fl 

POKE n, v Puis value ii (0 2551 into location n (1 5300 

to end of memory). See POKE Addresses. 

POKE 15872 p 255 

PRINT Prints an item or list at items, on tne display at 

current cursor position. 
PRINT X! * VI PRINT"U.S.A.- 



10 Prima beginning at n. r 1 = 0-1023. 

PRINT t 477. "CENTER" 

PRINT* - 1 Writes data to cassette. 

PRINT »-l ( A 

PRINT TAB Moves cursor right 10 specified lab position. 

PRINT TAB<Z0} "HAME" 

PRINT USING Formats stiings and numbers: 

# Formats numbers. 

PRINT USING "■■»»*"; SS.2 

Decimal poini, 

PRINT USING "•»,*" i5a.7G 

Displays comma to left of every third digit. 

PRINT USING ""«*.": 1234 

** Fills; leading spaces with asterisks. 

PRINT USING ■■*♦*»•»'■ 1 .44,0 
SS Floating cellar sign. 

PRINT USING "**■*»,»■■'! 11B,E735 
**% Floating dollar sign: fills leading spaces wrth asterisks. 

PRINT USING "!■**»,*»" i B,333 

[ Exponential format. Press QD to general!) this character. 

PH1NT USING ■■■»»,« [[[["; B5Z7103 

4 In first position, causes 3ign to be printed; in fast 
position, causes sign to be printed after the number. 
PRINT USING ■■ + •*«" 1 -21G 

Minus sign after negative numbers, space after posiiive. 
PRINT USING ■'»••«.■-"{ -8123.323 

I Returns first siring character. 

PRINT USING " ! YELLDW" 

%apaces% Siring field: length pi field is number of spaces 
plus 2. 
PRINT USING "I ■J," i "BLUE" 
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RANDOM 

RANDOM 



Reseeds random number generator. 



READ Reads value(s) from a DATA statement. 

READ T READ S* READ NM* . AGE 

REM Remark; instructs computer to ignore rest of line. ' 

is an abbreviation for :REM. 
REM PLACE COMMENTS HERE ' HERE TOO 

RESET (m, y) Turns off graphics block at specified 

location, x (horizontal) = 0-127; y(vertical) = 0-47. 
RESET (21. 40) RESET (LI, L2) 

RESTORE Resets data pointer to first item in first data 

line. 

RESTORE 

RESUME Ends an error-handling routine by specifying 

where normal execution is to resume. 

RESUME RESUME 40 RESUME NEXT 

RETURN Returns from subroutine to next statement 

after GOSUB. 
RETURN 



RUN 

RUN 



Executes resident program or portion of it. 

RUN 150 



SET (jc, y) Turns on graphics block at specified location, 

x (horizontal) = 0-127; y (vertical) = 0-47. 

SET ( 10 > 0) SET (LI . L2) 



STOP 

STOP 



Stops execution of a program. 



SYSTEM Puts computer in monitor mode, allows loading 

of object files. In response to *?, type filename or /address. 

SYSTEM 



TROFF 

TROFF 

TRON 

TRON 



Turns off the trace. 



Turns on the trace. 



BASIC 



Video Control Codes 



Dec 


Hex 


8 


08 


10 


0A 


13 


0D 


14 


0E 


15 


OF 


21 


15 


22 


16 


23 


17 


24 


18 


25 


19 


26 


1A 


27 


1B 


28 


1C 


29 


1D 


30 


1E 


31 


1F 



PRINT CHR$ (code) 

Backspaces and erases current character. 

Line feed with carriage return. 

Line feed with carriage return. 

Turns on cursor. 

Turns off cursor. 

Switches special/compression characters. 

Switches alternate characters. 

Shifts to 32-character mode. 

Backspaces cursor without erasing. 

Advances cursor. 

Downward line feed. 

Upward line feed. 

Homes cursor. 

Moves cursor to beginning of line. 

Erases to end of line. 

Clears to end of screen. 



Operators 



Each operator or group of operators is precedent over the group 
below it. 



♦ or[ 



-, + 
*,/ 
+ , - 

NOT 
AND 
OR 



Exponentiation (returns single-precision) 
Press (D to generate this operator; 
it will be displayed as a left 
bracket "[". 

Unary negative, positive 
Multiplication, division 
Addition and concatenation, subtraction 
,< = ,> = ,<> Relational tests 



Special Characters 



1 Abbreviation Igr :REM 

% Makes variable integer- precision. 

( Makes variable single-precision.. 

# Mhkbs variable dauoie-preclsiorr. 

S Makes variable string type. 

: Separates slalemeritg on the same line. 

? Same as PRINT {but l? can't be subsliluled fci lppint). 

, PRINT punctuation: spaces av&t 
to fie next 16-column PRINT zona. 

; pRirgT punrtualion; separates items irt a 

pfliiNT ilsl but does not add spaces when thay are 
output. 
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Edit Commands 



■CD 

■ID 

CE 

OD 

IX) 

otDc 

CD 

CJL> 

CTO 

*sesehb> 

-9 



Cancels changes and siarls again. 
Crianges n characters, 
Deletes fl characlecs. 
Ends editing and saves all ctianges- 
Hacks line and inserts al end 
Inserts chaiaclers. 

Kills all characters up to nlh occurrence at e. 
Lists Ihe tine. 

0i.ii5 edit mode and cancels all changes. 
■Searches lor nfi Dccurnenoe of c. 
Extends line (inserts ai end). 
Causes escape Irom Insert subcommand 
Records all ctianges and exits edit mode. 
Moves cursor n spaces to (he right- 
Moves cursor n spaces to Ihe left. 
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Control Keys 



s 


Cancels lasl character 




typed: movies cursor back one space, 


(HEEDS 


Erases tun-ant tine. 


■WEAK! 


Interrupts anything in progress and 
relume to command level. 


JBHB 


Clears the screen. 


■SHTHCi 


Signifies end of current line. 


SPACEHftN 


Enters a space (blank] character and 
moves cursor ane space forward 


e 


Advances cursor to nest lab position. 


shees 


Puts display in 32-tharac)ler mode- 


(B 


Line, feed and carriage return. 


(SEED® 


"Control" Key— hold down ihese 

two and press any key A-Z for contra' A 

control Z. 


Baaj-ffl-Q 


Copies ma display contents to (he 
printer. 


Mffp.e 


Causes currently executing program to 



pause (press any key to continue). 



PRINTED IN U.S. A. 
8759038-591 



MBtMMB 



Functions 



Argument ranges are indicated below biy special letters: 

x: (-IxlQE 38.-1 xlO E -3B),(1j<10 E 38,lvlOE3a| 

c: (0,255) 

W. { 3276S, 32767) 

Str. siring argumeril 

VX: variable name 

ABS(<> Corrputes absolute vaiua. 

Y = A05(X1 

\SCiatr) Re-turns ascii code oi first chafacisr of stflng. 

A = ASC(T*f 

ATN(jr) Computes arctangent, i/alue relumed in radians. 

CDBL<i) Converts 10 double-precision. 

■■'■' = C[J&LiN*3) 

CHR$(<-) Returns cnaiacl&r for ASCII, control, or 

graphics code. 
P* = CHRttT) 

CINTf a) Returns largesl integer not greater than n, 

PfVlMT CINT ( 1S,0U?S> 

COS(x) Computes cosine: angle must be in radians. 

Y = CD5IX) 

CSNG(jr) Converts to single- precision. 

FC ■ C5NE(tfl«f 

EHL Heturng the line number in which an error has 

OMurr&d. 
PRINT ERL 

ERR If an error occurs, returns a value related to the 

error code: value returned - {error code l)*2. 

IF ERR = 1Z THEN 650 ELSE 319 

LXP(jt) Compulse natural anlilog. 

v ■ exp<x) 

FIX(*r) Truncates all digits to right oi decimal point. 

Y « FIX(X) 

FKE(nvmerrc) Finds amount of free memory. 

F = FftEUl PftlNT FRE( t*) 

FHE(s( r ) Relurns amount of unused string space, str is 

any String Constant or string variable, 
rr^rf -z ■ i ff>t'.0t> 

INKEV$ Gets keyboard character if available. 

A* = INKEY* 




INP(p} Gelt va ue from specified pert, p 255. 

U = INP(Z55r- 

INTj *) Returns fargsst whole number not greater than x. 

V = INHX) 

LEFT$(*tr, c) Returns left portion of string. 

F»=L.EFTt(l1* t 7) 

LEN(sat) Retum$ the number ol ctiareeiers ir> a -airing 

K = LEN(SENI-) 

LOG(x) Computes natural logarithm. 

Y = LDGtX) 

MEM Finds amount of free memory. 

PRINT MEM 

MlD${atring, pom, fen) Pel urns a £U Petting of andher 

string. If length option is omllled, the entire stnng right of 
pas is. relumed. 

PRINT MID4<fl*i 3, 2\ F*=MfD*(flti 3) 

PEEK (a) Gets value m location n (n = to end of 

memory). 
V-PEE«Ua5Zfl> 

HOIN'J(jt, y) Tests whether specified graphics block is 

on or off. x (horizonTal) = - 127; y (vertical} = 0- 47. 
IF POINT (13,351 THEN PRINT "UN" ELSE 
PRINT "OFF" 

POSU) Returns column position af cursor (0-63}. r. is 

a dummy argument. 

PRINT Y A6UB> POStai 

MGHT${mtr, c) Returns, right portion of string. 

ZIP* = RIGHT*(ADt. 5> 

RNO(rt) Generates a '"randfjrn" number between 1 arid 

n it n > 1 . or between and 1 ii r- = 0. 
¥ ■ RNDtlflfl) PRINT PND!#) 

R = RND(K) 

SGN(x) Returns sign corripon&nl: -1, 0, I, IF x is 

negative, zero, positive. 

y, = SGN<A*B) 

SlNl» Computes sine: angle must be in radians. 

t = BIN(X> 

SQR(x) . Computes square root. 

Y = EDR<fl +■ B) 

$TR$<*) Converts a numeric expression to a string. 

S» « STRi(X> 

STRINGifl, c) Hedurns string of characters of length '. 

Character c can he specified as an ASCII code o" as. a 
string. 

B* = STRING* (125* "?" > 
Bt = STRING* (125 . Km 
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TAN(x) Computes tangent; angle must be in radians. 

Y = TAN(X> 

TIME$ Returns the time (in 24-hour format) and the date 

as a 17-character string. 

A* = TIME$ 

USR(x) Calls a machine-language subroutine whose 

address is stored at 1 6526 - 1 6527. 
PRINT USR(-1 ) X = USR(Y) 

VAL(str) Evaluates a string as a number. 

U2 = UAL< "100 DOLLARS" ) 

VARPTR( var) 

are stored. 

Y = USR (YARPTR (X) ) 



Gets address where variable contents 



Error Messages 



Code 


Abbreviation 


Explanation 


1 


NF 


NEXT Without FOR 


2 


SN 


Syntax error 


3 


RG 


RETURN Without GOSUB 


4 


OD 


Out of data 


5 


FC 


Illegal function call 


6 


OV 


Overflow 


7 


OM 


Out of memory 


8 


UL 


Undefined line 


9 


BS 


Subscript out of range 


10 


DD 


Redimensioned array 


11 


/O 


Division by zero 


12 


ID 


Illegal direct 


13 


TM 


Type mismatch 


14 


OS 


Out of string space 


15 


LS 


String too long 


16 


ST 


String formula too complex 


17 


CN 


Can't continue 


18 


NR 


No RESUME 


19 


RW 


RESUME without error 


20 


UE 


Undefined error 


21 


MO 


Missing operand 


22 


FD 


Bad file data 


23 


L3 


Disk BASIC feature 



POKE Addresses 



By POKEing various values into the addresses listed 
below, you can activate or control many of the Mode 
Ill's special features. See the Owner's Manual fot 
details. 

Sample Use 

To select the High cassette rate, execute: 
POKE 16913. 1 



Address 




Initial 


Dec 


Hex 


Contents 


Contents 


16409 


4019 


Caps Lock Switch 

= "Upper and Lower Case" 

Not = "Caps Only" 


"Caps" 


16412 


401 C 


Cursor Blink Switch 

= "Blink" 

Non-Zero = "No-Blink" 





16416 


4020 


Cursor Address 
Two bytes: LSB, MSB 


N/A 


16419 


4023 


Cursor Character 
ASCII Code - 255 


176 


16424 


4028 


Maximum Lines/Page 
plus one 


67 


16425 


4029 


Number of lines printed 
plus one 


1 


16427 


402B 


Line Printer Max. Line 

length less two. 

255 = "No Maximum" 


255 


16526 


408E 


Address of USR Routine 
Two Bytes: LSB, MSB 


7754 


16872 


41 E8 


$RSRCV Input Buffer 
One byte 





16880 


41 F0 


$RSTX Output Buffer 
One byte 






16888 41 F8 

16889 41 F9 

16890 41 FA 

16913 4211 

16916 4214 

16919 4217 

16928 4220 

16930 4222 



SRSINIT Baud Rate Code 85 

TX Code = Most Sig. Nibble 
RCV Code = Least Sig. Nibble 

$RSINIT Parity/Word Length/ 108 
Stop-Bit Code 

SRSINIT Wait Switch "Wait" 

= "Don't Wait" 
Non-Zero = "Wait" 

Cassette Baud Rate Switch N/A 

= 500 Baud 
Non-Zero = 1500 Baud 

Video Display Scroll Protect 

From to 7. Greater values 
are interpreted in modulo 8 

Time-Date 

Six binary bytes: 

SS MM HH YY DD MM 

$ROUTE Destination Device N/A 
Two-byte I/O designator 

$ROUTE Source Device N/A 

Two-byte I/O designator 



Z-80 ROM Subroutines 



The following rom subroutines may be used by z-80 
programs; some may also be used by basic programs 
via the usr function. Before trying to use any of 
these, read the Technical Information Section of 
your Owner's Manual. 



MODEL 



Address 




Dec 


Hex 


Contents 


Function 





0000 


$RESET 


System reset 


43 


002B 


$KBCHAR 


Check for keyboard character 


51 


0033 


$VDCHAR 


Display a character 


59 


003B 


$PRCHAR 


Print a character 


64 


0040 


$KBLINE 


Wait for a keyboard line 


73 


0049 


$KBWAIT 


Wait for a keyboard character 


80 


0050 


$RSRCV 


Receive character from RS-232-C 


85 


0055 


$RSTX 


Transmit character to RS-232-C 


90 


005A 


$RSINIT 


Initialize RS-232-C 


96 


0060 


$DELAY 


Delay for a specified time 


105 


0069 


SINITIO 


Initialize all I/O drivers 


108 


006C $ROUTE 


Route I/O 


457 


01 C9 


$VDCLS 


Clear the screen 


473 


01 D9 


$PRSCN 


Print screen contents 


539 


021 B 


$VDLINE 


Display a line 


565 


0235 


$CSIN 


Input a cassette byte 


612 


0264 


$CSOUT 


Output a cassette byte 


647 


0287 


$CSHWR 


Write the cassette header 


653 


028D 


$KBBRK 


Check for flREAK) key only 


662 


0296 


$CSHIN 


Read the cassette header 


664 


0298 


$CLKON 


Turn on the clock display 


673 


02A1 


SCKLOFF 


Turn off the clock display 


6681 


1A19 


$READY 


Jump to BASIC "READY" 


12339 3033 


$DATE 


Get the date 


12342 3036 


$TIME 


Get the time 


12354 3042 


SSETCAS 


Set cassette baud rate 


14312 37E8 


SPRSTAT 


Printer status 








(Read Only) 








"Go" only if: 








Bit 7 = "NOT BUSY" 








Bit 6 = "NOT OUT OF PAPER 








Bit 5 = 1 "DEVICE SELECT" 








Bit 4 = 1 "NOT PRINTER FAULT 



Bits 3,2,1 and are not used. 



Ill BASIC 



